home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_elm.idb / usr / freeware / catman / u_man / cat1 / readmsg.Z / readmsg
Encoding:
Text File  |  1998-10-28  |  8.2 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      RRRREEEEAAAADDDDMMMMSSSSGGGG((((1111LLLL)))) UUUUSSSSEEEENNNNEEEETTTT    CCCCoooommmmmmmmuuuunnnniiiittttyyyy TTTTrrrruuuusssstttt    ((((EEEEllllmmmm VVVVeeeerrrrssssiiiioooonnnn 2222....4444))))  RRRREEEEAAAADDDDMMMMSSSSGGGG((((1111LLLL))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       readmsg - extract messages from a mail folder
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       rrrreeeeaaaaddddmmmmssssgggg [----aaaannnnhhhhpppp] [----ffff folder] [selection ...]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.       _R_e_a_d_m_s_g extracts selected mail messages from a mail folder.
  16.       One helpful use of the program is when you are composing a
  17.       response to a    mail message in    an external editor.  In    this
  18.       case,    you can    run _r_e_a_d_m_s_g to pull a copy of the original
  19.       message into the editing buffer.
  20.  
  21.       When you run _r_e_a_d_m_s_g from within _e_l_m (e.g. from a subshell
  22.       escape or in an external editor while    composing a mail
  23.       reply) it behaves a bit differently from when    you run    it
  24.       directly (e.g. from a    shell command line).  We will first
  25.       describe its normal behavior,    and then describe how it is
  26.       different when you run it under _e_l_m.
  27.  
  28.       You tell _r_e_a_d_m_s_g which messages to extract with the
  29.       _s_e_l_e_c_t_i_o_n argument.  There are a couple of possible
  30.       different ways to specify the    _s_e_l_e_c_t_i_o_n.
  31.  
  32.       1.   A lone ``*'' means select all messages in the mailbox.
  33.  
  34.       2.   A list of message numbers may be    specified.  Values of
  35.            ``0'' and ``$'' in the list both    mean the last message
  36.            in the mailbox.    For example:
  37.  
  38.             readmsg 1 3    0
  39.  
  40.            extracts    three messages from the    folder:     the first,
  41.            the third, and the last.
  42.  
  43.       3.   Finally,    the _s_e_l_e_c_t_i_o_n may be some text to match.  This
  44.            will select a mail message which    _e_x_a_c_t_l_y    matches    the
  45.            specified text.    For example,
  46.  
  47.             readmsg staff meeting
  48.  
  49.            _e_x_t_r_a_c_t_s    _t_h_e _m_e_s_s_a_g_e _w_h_i_c_h _c_o_n_t_a_i_n_s _t_h_e _w_o_r_d_s ``_s_t_a_f_f
  50.            _m_e_e_t_i_n_g.''  _N_o_t_e    _t_h_a_t _i_t    _w_i_l_l _n_o_t match a message
  51.            containing ``Staff Meeting''  the matching is case
  52.            sensitive.  Normally only the first message which
  53.            matches the pattern will    be printed.  The ----aaaa option
  54.            discussed in a moment changes this.
  55.  
  56.       The ----ffff flag indicates    that you'd rather use the folder
  57.       specified rather than    the default incoming mailbox.  The
  58.       specified _f_o_l_d_e_r can be a filename or    a specification    such
  59.       as ``=sentmail''.
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 6/11/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      RRRREEEEAAAADDDDMMMMSSSSGGGG((((1111LLLL)))) UUUUSSSSEEEENNNNEEEETTTT    CCCCoooommmmmmmmuuuunnnniiiittttyyyy TTTTrrrruuuusssstttt    ((((EEEEllllmmmm VVVVeeeerrrrssssiiiioooonnnn 2222....4444))))  RRRREEEEAAAADDDDMMMMSSSSGGGG((((1111LLLL))))
  71.  
  72.  
  73.  
  74.       The ----hhhh flag instructs    the program to include the entire
  75.       header of the    matched    message    or messages when displaying
  76.       their    text.  (default    is to display the From:    Date: and
  77.       Subject: lines only)
  78.  
  79.       The ----nnnn flag instructs    the program to exclude _a_l_l headers.
  80.       This is used mostly for extracting files mailed and such.
  81.  
  82.       The ----pppp flag indicates    that the program should    put form-feeds
  83.       (control-L) between message headers.
  84.  
  85.       The ----aaaa flag indicates    that all messages which    match the
  86.       pattern specified on the command line    should be printed, not
  87.       just the first.  If a    pattern    was not    specified on the
  88.       command line then this flag has no effect.
  89.  
  90.       When you run _r_e_a_d_m_s_g under _e_l_m (once again, say in the
  91.       context of an    external editor) the behavior will be
  92.       different from that described    above as follows.
  93.  
  94.       1.   The default mail    folder will be the folder you are
  95.            currently examining in _e_l_m and not necessarily your
  96.            incoming    mail folder.
  97.  
  98.       2.   You do not need to specify a _s_e_l_e_c_t_i_o_n on the command
  99.            line.  If you omit the _s_e_l_e_c_t_i_o_n    then _r_e_a_d_m_s_g will
  100.            extract the message(s) you have selected    in Elm.     If
  101.            you have    tagged any messages then this would be all of
  102.            the tagged messages, otherwise it would be the message
  103.            you are currently examining.
  104.  
  105.       3.   Normally    the message numbers _r_e_a_d_m_s_g uses are in
  106.            mailbox order.  When you    call _r_e_a_d_m_s_g under _e_l_m and do
  107.            not override the    folder selection with the ----ffff option,
  108.            then message numbers will be sorted as they are
  109.            displayed on the    _e_l_m message index screen.
  110.  
  111.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  112.       First    off, to    use this from within vvvviiii    to include the text of
  113.       the current message, you could use the command:
  114.  
  115.            :r !readmsg
  116.  
  117.       (as you hit the ':' the editor will put you at the bottom of
  118.       the screen with the ':' prompt).  The    space following    ':r'
  119.       is required.
  120.  
  121.  
  122.       Let's    look at    something more interesting, however;
  123.  
  124.       Suppose you have the mail file;
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 6/11/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      RRRREEEEAAAADDDDMMMMSSSSGGGG((((1111LLLL)))) UUUUSSSSEEEENNNNEEEETTTT    CCCCoooommmmmmmmuuuunnnniiiittttyyyy TTTTrrrruuuusssstttt    ((((EEEEllllmmmm VVVVeeeerrrrssssiiiioooonnnn 2222....4444))))  RRRREEEEAAAADDDDMMMMSSSSGGGG((((1111LLLL))))
  137.  
  138.  
  139.  
  140.          From joe Jun 3 1986 4:45:30 MST
  141.          Subject: hello
  142.  
  143.          Hey Guy!  Wanta go    out and    have a milk this evening?
  144.  
  145.          Joe
  146.  
  147.          From john Jun 3 1986 4:48:20 MST
  148.          Subject: Dinner at    Eight
  149.          From: John    Dinley <xyz!john>
  150.  
  151.          Remember you should show up about eight, okay?
  152.  
  153.                - John D    -
  154.  
  155.          From xxzyz!cron Jun 3 1986    5:02:43    MST
  156.  
  157.          Cannot connect to server: blob
  158.          Job 43243 deleted from queue.
  159.  
  160.       The following    commands will result in;
  161.  
  162.         $ readmsg 2
  163.         [ display the second message, from John ]
  164.  
  165.         $ readmsg
  166.         [ an error,    unless we're calling from _e_l_m ]
  167.  
  168.         $ readmsg BLOB
  169.         [ no match - case sensitive! ]
  170.  
  171.         $ readmsg -h connect to server
  172.         [ displays third message, including    headers    ]
  173.  
  174.  
  175.      FFFFIIIILLLLEEEESSSS
  176.       /usr/mail/<username>        The incoming mail
  177.       $ELMSTATE          Status information from _e_l_m
  178.  
  179.      AAAAUUUUTTTTHHHHOOOORRRR
  180.       Elm Development Group
  181.  
  182.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  183.       newmail(1L), elm(1L)
  184.  
  185.      BBBBUUUUGGGGSSSS
  186.       The '*' metacharacter    doesn't    always work as expected!
  187.       Perhaps the pattern matching should be case insensitive?
  188.       It might be confusing    that messages are sorted when running
  189.       under    _e_l_m with the current folder, and in mailbox order for
  190.       all other cases.
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 6/11/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      RRRREEEEAAAADDDDMMMMSSSSGGGG((((1111LLLL)))) UUUUSSSSEEEENNNNEEEETTTT    CCCCoooommmmmmmmuuuunnnniiiittttyyyy TTTTrrrruuuusssstttt    ((((EEEEllllmmmm VVVVeeeerrrrssssiiiioooonnnn 2222....4444))))  RRRREEEEAAAADDDDMMMMSSSSGGGG((((1111LLLL))))
  203.  
  204.  
  205.  
  206.      BBBBUUUUGGGG RRRREEEEPPPPOOOORRRRTTTTSSSS TTTTOOOO
  207.       Syd Weinstein     elm@DSI.COM    (dsinc!elm)
  208.  
  209.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTTSSSS
  210.       Copyright 1988-1992 by The USENET Community Trust
  211.       Derived from Elm 2.0,     Copyright 1986, 1987 by Dave Taylor
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 6/11/98)
  262.  
  263.  
  264.  
  265.